home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 1.iso / util / pwrm154.zip / powermon.doc < prev    next >
Text File  |  1995-04-18  |  6KB  |  152 lines
  1.  
  2.                    PowerMon  Version 1.54
  3.                   Release date: 18.04.1995
  4.                   (C)1993-95 by Heiko Boch
  5.  
  6.  
  7. I. PowerMon - what it is
  8. PowerMon reports the battery status of your computer. It draws
  9. a little battery into the caption of the topmost window and into
  10. its own icon. The fill level of these bitmaps corresponds to
  11. the fill level of your computer's battery.
  12. PowerMon takes advantage of APM (Advanced Power Management)
  13. facilities of modern notebooks running a DOS/Windows configu-
  14. ration. Since the BIOS of these computers keep track of the
  15. battery status PowerMon can display the battery level.
  16. Note that PowerMon does no own computations but relies on the
  17. data the BIOS supplies.
  18.  
  19.  
  20. II. What you need to run PowerMon
  21. PowerMon is a Windows 3.1 application. Therefore you need DOS
  22. with Windows 3.1; your notebook should have a BIOS that supplies
  23. APM 1.0 functions. If your computer's BIOS does not have APM
  24. functions, PowerMon will report an error or just unknown battery
  25. status (a battery with a question mark).
  26. PowerMon needs a 386 or better.
  27.  
  28.  
  29. III. How to install PowerMon
  30. You have to do three steps:
  31.  + Copy POWERMON.EXE into any directory you want.
  32.  + Add the program to the Program Manger's Autostart group.
  33.  + Restart Windows.
  34.  
  35. Optional:
  36. For easier setup copy PMSETUP.EXE and BWCC.DLL, too.
  37. PMSETUP manages PowerMon's WIN.INI entries, you can switch them
  38. in a dialog rather than editing the file.
  39. Note: You don't need the DLL if you have a BWCC.DLL either in
  40. your \windows directory or in your \windows\system directory.
  41. PowerMon itself does not use it. It's only for the setup program,
  42. so if you don't use PMSETUP you do not need the DLL at all.
  43.  
  44. If you want to log the power status over time, you have to copy
  45. PMLOG.EXE into the same directory (in this case you have to
  46. specify a log buffer size either by running the PMSETUP.EXE or
  47. by editing the WIN.INI entries with an editor - see section VIII
  48. for possible entries).
  49.  
  50.  
  51. IV. Contacting the author
  52. Feel free to send me any comments or ideas for further
  53. development.
  54.  
  55. Write to: Heiko Boch
  56.           Alter Schulweg 5
  57.           35579 Wetzlar
  58.           Germany
  59.  
  60. Internet: boch@rbg.informatik.th-darmstadt.de
  61.  
  62.  
  63. V. Disclaimer
  64. THIS SOFTWARE IS PROVIDED "AS IS". THERE IS NO WARRANTY, WETHER
  65. EXPRESS NOR IMPLIED. THE AUTHOR DOES NOT ACCEPT ANY LIABILITIES
  66. WITH RESPECT TO THIS PROGRAM.
  67.  
  68.  
  69. VI. Copyright
  70. You are allowed to use this version of PowerMon for free.
  71. You may distribute the program to others as long as you don't
  72. charge any fee and as long as there are no changes made with
  73. the program and this document.
  74. You may not include this program with a commercial product
  75. without a written permission of the author.
  76.  
  77.  
  78. VII. Trouble shooting
  79. (1) Some manufacturer claim that their computers have an APM BIOS,
  80.     but in fact it's not true. So I have added a small check
  81.     program (APMCHECK.EXE) with this distribution. It shows the
  82.     results from a call to the APM init function. If you have
  83.     problems with PowerMon you should run this utility and check
  84.     its results.
  85. (2) Please note that setup changes you do either with PMSETUP.EXE
  86.     or by editing the WIN.INI file don't affect a running PowerMon
  87.     task. So you will have to restart PowerMon in order to apply
  88.     setup changes to PowerMon.
  89. (3) Some systems may have problems with Windows' WM_POWER message. 
  90.     If you have trouble after suspend/resume you can try to set
  91.     ignoreWMPower=1 in WIN.INI; btw: did you specify your machine
  92.     type as system with APM in Windows' setup program?
  93.  
  94.  
  95. VIII. PowerMon's WIN.INI entries
  96. (the shown values are default values):
  97.  
  98. [PowerMon]
  99. hide=0
  100. onTop=0
  101. moveIcon=0
  102. drawIcon=1
  103. drawCaption=1
  104. captionOffset=0
  105. drawPlug=1
  106. drawBW=0
  107. criticalPower=0
  108. titleFormat=0
  109. checkInterval=30
  110. powerLogBufferLen=0
  111. ignoreWMPower=0
  112.  
  113. If you set "hide" to any non zero value, PowerMon hides its icon.
  114. With "onTop" set to a non zero value PowerMon's icon will stay in
  115. front of all applications (if the icon is not hidden).
  116. A nonzero "moveIcon" moves the icon to the place where it stayed
  117. in last session (on the first start this will be the upper left
  118. corner).
  119. If "drawIcon" is set to zero, PowerMon will do no paintings in
  120. its icon. The icon will be always a full battery.
  121. "drawCaption" is the same flag for caption paintings: if it is
  122. zero, PowerMon will not draw in the caption bar.
  123. If you have other programs showing informations in the caption bar
  124. you might want to specify an offset for PowerMon's caption bar
  125. display in order to save other stuff. Set "captionOffset" to the
  126. desired offset value (in pixels).
  127. A non zero "drawPlug" value makes PowerMon painting a plug if
  128. your notebook runs with an external power supply.
  129. If your computer does not have a color display you may want
  130. PowerMon to draw black and white only. In that case set "drawBW"
  131. to one.
  132. If your battery capacity is less or equal than "criticalPower"
  133. percentage, PowerMon displays a critical battery message on the
  134. screen. The language depends on the country you have selected
  135. in Windows Setup: it is German for Germany, Austria and (German)
  136. Switzerland, English for all other countries.
  137. If you do not want such a message set "criticalPower" to a
  138. negative value.
  139. If you don't like the standard icon title you can choose another
  140. with "titleFormat" set to a value of 1 or 2:
  141.         default:         "PowerMon (100%)",
  142.         titleFormat = 1: "(100%)" or
  143.         titleFormat = 2: "(100%) PowerMon"
  144. With "checkInterval" you can specify the interval when PowerMon
  145. checks actual power status. Default is 30 seconds. If you specify
  146. an interval of 0, PowerMon will do no periodic checks.
  147. If You want to run PowerMonLog you have to install a log buffer by
  148. setting "powerLogBufferLen" to de desired buffer size.
  149. a nonzero value for "ignoreWMPower" makes PowerMon ignoring
  150. Windows' WM_POWER messages. 
  151.  
  152.